home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / gfx / board / cgfxvilintui.lha / vilintuisup.readme < prev   
Text File  |  1995-02-05  |  3KB  |  99 lines
  1. vilintuisup.library emulation for CyberGraphics software
  2. ========================================================
  3. This document describes vilintuisup.library v2.27 which is a plug-in
  4. compatible emulation of the original vilintuisup.library supplied
  5. with the Picasso II software which requires the CyberGraphics
  6. software v40 or higher to run.
  7.  
  8.  
  9. 1. Software compatibility
  10. -------------------------
  11. The emulation has been tested with a number of programs; these include
  12. the original image viewers supplied with the Picasso II software, the
  13. Emplant and A-Max IV Apple Macintosh emulations and image processing
  14. software such as TVPaint 2.0, XiPaint 1.30, ADPro 2.5 and PhotoworX.
  15.  
  16. 1.1 Emplant
  17. -----------
  18. The CyberGraphics software requires more memory than the original
  19. Picasso II software. Lower your Macintosh memory assignment, or
  20. otherwise Emplant will crash when opening the display.
  21.  
  22. 1.2 XiPaint 1.30
  23. ----------------
  24. XiPaint is reported not to work at all with the emulation.
  25.  
  26. 1.3 ADPro 2.5
  27. -------------
  28. Reportedly, the Picasso II render option does not work and causes
  29. Enforcer hits. You may have to resort to the old Picasso II saver
  30. module shipped with the Picasso II software.
  31.  
  32. 1.4 Other software
  33. ------------------
  34. Unfortunately, crashes are a very common sight when running some
  35. public domain and commercial applications designed to use the
  36. Picasso II support software. It is recommended that you save all
  37. your work before you give any such software a try. Be prepared.
  38.  
  39.  
  40. 2. Technical description
  41. ------------------------
  42. While the emulation tries to reproduce the behaviour of the original
  43. library there are a few drawbacks. These include:
  44.  
  45. - If the ViewModeID you pass to OpenVillageScreen() does not
  46.   refer to a valid CyberGraphics monitor ID the library will
  47.   construct an ID for you, based upon the depth, width and
  48.   height you supply.
  49.  
  50. - VillageBlitCopy() only supports four raster operations:
  51.  
  52.       VIL_SRCCOPY
  53.       VIL_DSTINVERT
  54.       VIL_ONE
  55.       VIL_ZERO
  56.  
  57.   All other operations will leave the destination untouched.
  58.  
  59. - GetMemSize() always reports a 2MByte card to be installed,
  60.   regardless of how your hardware setup looks like.
  61.  
  62. - VillageModeRequest() only supports the following nine tags:
  63.  
  64.       TAVIS_MINDEPTH
  65.       TAVIS_MINWIDTH
  66.       TAVIS_MINHEIGHT
  67.       TAVIS_MAXDEPTH
  68.       TAVIS_MAXWIDTH
  69.       TAVIS_MAXHEIGHT
  70.       TAVIS_WINDOWTITLE
  71.       TAVIS_OKGADGET
  72.       TAVIS_CANCELGADGET
  73.  
  74.   All other tags will be ignored.
  75.  
  76. - VillageGetSegment() will always return 0xFFFFFFFF, indicating
  77.   that the graphics card memory is not segmented.
  78.  
  79. - OpenVillageScreenTagList() does not support the
  80.   TAVIS_DOUBLE_BUFFER tag. If the ViewModeID you pass in does not
  81.   refer to a valid CyberGraphics monitor ID the library will
  82.   construct an ID for you, based upon the depth, width and
  83.   height you supply.
  84.  
  85. - VillageScreenData() will always report that the graphics card
  86.   memory is 2MBytes in size and that the memory is not segmented.
  87.  
  88. - VillageGetBufAddr() will always return 0.
  89.  
  90. In some areas the emulation may be more tolerant than the original
  91. vilintuisup.library, in some areas less tolerant. If a program relies
  92. upon certain side-effects characteristic only of the original library
  93. it may see the intended operations fail. If a program is not prepared
  94. to handle such conditions a system crash may result.
  95.  
  96. If you write software that uses vilintuisup.library you should base
  97. your development on how the original Picasso II software works and
  98. responds.
  99.